home *** CD-ROM | disk | FTP | other *** search
/ X User Tools / X User Tools (O'Reilly and Associates)(1994).ISO / sun4c / archive / tcltk.z / tcltk / man / cat1 / tclsh.1 next >
Text File  |  1994-09-20  |  4KB  |  133 lines
  1.  
  2.  
  3.  
  4. tclsh(1)                Tcl Applications
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NAME
  11.      tclsh - Simple shell containing Tcl interpreter
  12.  
  13. SYNOPSIS
  14.      tclsh ?_f_i_l_e_N_a_m_e _a_r_g _a_r_g ...?
  15. _________________________________________________________________
  16.  
  17.  
  18. DESCRIPTION
  19.      Tclsh is a shell-like application that  reads  Tcl  commands
  20.      from  its  standard input or from a file and evaluates them.
  21.      If invoked with no arguments  then  it  runs  interactively,
  22.      reading  Tcl  commands from standard input and printing com-
  23.      mand results and error messages to standard output.  It runs
  24.      until  the  exit command is invoked or until it reaches end-
  25.      of-file on its standard  input.   If  there  exists  a  file
  26.      .tclshrc  in the home directory of the user, tclsh evaluates
  27.      the file as a Tcl script just before reading the first  com-
  28.      mand from standard input.
  29.  
  30.  
  31. SCRIPT FILES
  32.      If tclsh is invoked with arguments then the  first  argument
  33.      is  the  name  of a script file and any additional arguments
  34.      are made available to the script as variables  (see  below).
  35.      Instead  of  reading commands from standard input tclsh will
  36.      read Tcl commands from the named file;  tclsh will exit when
  37.      it  reaches  the  end  of  the  file.  There is no automatic
  38.      evaluation of .tclshrc in this case, but the script file can
  39.      always source it if desired.
  40.  
  41.      If you create a Tcl script in a file whose first line is
  42.  
  43.           #!/usr/local/bin/tclsh
  44.  
  45.      then you can invoke the script file directly from your shell
  46.      if you mark the file as executable.  This assumes that tclsh
  47.      has   been   installed   in   the   default   location    in
  48.      /usr/local/bin;   if  it's  installed  somewhere  else  then
  49.      you'll have to modify the above line to match.
  50.  
  51.  
  52. VARIABLES
  53.      Tclsh sets the following Tcl variables:
  54.  
  55.      argc           Contains a count of the number of  _a_r_g  argu-
  56.                     ments  (0 if none), not including the name of
  57.                     the script file.
  58.  
  59.      argv           Contains a Tcl list whose  elements  are  the
  60.                     _a_r_g  arguments,  in order, or an empty string
  61.  
  62.  
  63.  
  64. Tk                                                              1
  65.  
  66.  
  67.  
  68.  
  69.  
  70. tclsh(1)                Tcl Applications
  71.  
  72.  
  73.  
  74.                     if there are no _a_r_g arguments.
  75.  
  76.      argv0          Contains _f_i_l_e_N_a_m_e if it was specified.   Oth-
  77.                     erwise,  contains the name by which tclsh was
  78.                     invoked.
  79.  
  80.      tcl_interactive
  81.                     Contains 1 if tclsh is running  interactively
  82.                     (no _f_i_l_e_N_a_m_e was specified and standard input
  83.                     is a terminal-like device), 0 otherwise.
  84.  
  85. PROMPTS
  86.      When tclsh is invoked interactively it normally prompts  for
  87.      each command with ``% ''.  You can change the prompt by set-
  88.      ting the variables tcl_prompt1 and tcl_prompt2.  If variable
  89.      tcl_prompt1  exists  then it must consist of a Tcl script to
  90.      output a prompt;  instead of outputting a prompt tclsh  will
  91.      evaluate   the   script   in   tcl_prompt1.    The  variable
  92.      tcl_prompt2 is used in a similar way when a newline is typed
  93.      but  the  current command isn't yet complete; if tcl_prompt2
  94.      isn't set then no prompt is output for incomplete commands.
  95.  
  96.  
  97. KEYWORDS
  98.      argument, interpreter, prompt, script file, shell
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.  
  128.  
  129. Tk                                                              2
  130.  
  131.  
  132.  
  133.